home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Libraries / CW GUSI 1.6.4 / doc / pod / GUSI_Appletalk.pod < prev    next >
Encoding:
Text File  |  1995-03-11  |  1.5 KB  |  39 lines  |  [TEXT/CWIE]
  1. =head1 Appletalk sockets
  2.  
  3. Currently, only stream sockets (including out-of-band data)
  4. are supported. Appletalk sockets should work between all networked Macintoshes
  5. and between applications on a single Mac, provided the SetSelfSend flag is turned 
  6. on. However, PPC sockets have a better performance for interapplication communication
  7. on a single Machine.
  8.  
  9. =head2 Differences to generic behavior
  10.  
  11.  
  12. Two classes of addresses are supported for AppleTalk. The main address type
  13. specifies numeric addresses.
  14.  
  15.     struct sockaddr_atlk {
  16.       short       family;     /* Always AF_APPLETALK                  */
  17.       AddrBlock   addr;       /* The numeric AppleTalk socket address   */
  18.     };
  19.  
  20. For C<bind()> and C<connect()>, however, you are also allowed to specify symbolic
  21. addresses. C<bind()> registers an NBP address, and C<connect()> performs an NBP
  22. lookup. Registered NBP adresses are automatically released when the socket is
  23. closed. No call ever I<returns> a symbolic address.
  24.  
  25.     struct sockaddr_atlk_sym {
  26.       short       family;     /* Always ATALK_SYMADDR     */
  27.       EntityName  name;       /* The symbolic NBP address   */
  28.     };
  29.  
  30. C<choose()> currently only works for existing sockets. The peer must have registered
  31. a symbolic address. To restrict the choice of addresses presented, pass a pointer
  32. to the following structure for the C<constraint> argument:
  33.  
  34.     typedef struct {
  35.       short       numTypes;   /* Number of allowed types */
  36.       NLType      types;      /* List of types */
  37.     } sa_constr_atlk;
  38.  
  39.